Android 沉浸式解析和轮子使用

文 | 黑羽 on 移动电商

前言

我们先一起来回顾一下实现沉浸式状态栏的一般套路。在 Android 上，关于对 StatusBar（状态栏）的操作，一直都在不断改善，并且表现越来越好，在 Android4.4 以下，我们可以对 StatusBar 和 NavigationBar 进行显示和隐藏操作。但是直到 Android4.4,我们才能真正意义上的实现沉浸式状态栏。从 Android4.4 到现在（Android 9），关于沉浸式大概可以分成三个阶段：

• Android4.4（API 19）- Android 5.0（API 21）：这个阶段可以实现沉浸式，但是表现得还不是很好，实现方式为: 通过 FLAGTRANSLUCENTSTATUS 设置状态栏为透明并且为全屏模式，然后通过添加一个与 StatusBar 一样大小的 View，将View 的 background 设置为我们想要的颜色，从而来实现沉浸式。

• Android 5.0（API 21）以上版本：在Android 5.0 的时候，加入了一个重要的属性和方法 android:statusBarColor （对应方法为 setStatusBarColor），通过这个方法我们就可以轻松实现沉浸式。也就是说，从 Android5.0 开始，系统才真正的支持沉浸式。

• Android 6.0（API 23）以上版本：其实 Android6.0 以上的实现方式和 Android 5.0+是一样，为什么要将它归为一个单独重要的阶段呢？是因为从 Android 6.0（API 23）开始，我们可以改状态栏的绘制模式，可以显示白色或浅黑色的内容和图标（除了魅族手机，魅族自家有做源码更改，6.0 以下就能实现）。

总结：这三个阶段的 Android 上 API 版本混乱，各种 Flag 林立。再加上各大厂商的定制化可谓是火上浇油，让安卓开发者异常头疼。

一、沉浸式三个阶段使用

我们将从沉浸式支持的三个阶段和支持的功能出发，去了解出现的相关背景，然后去了解怎么实现三个阶段的沉浸式。

1.1 Android4.0-Android5.0设置沉浸体验

在 android4.4 及以上版本中为 setSystemUiVisibility() 方法引入了一个新的 flag:SYSTEMUIFLAGIMMERSIVE，它可以使你的 app 实现真正意义上的全屏体验。当 SYSTEMUIFLAGIMMERSIVE、SYSTEMUIFLAGHIDENAVIGATION 和SYSTEMUIFLAG_FULLSCREEN 三个 flag 一起使用的时候，可以隐藏状态栏与导航栏，同时让你的app可以捕捉到用户的所有触摸屏事件。从 Android4.4 以上版本才是真正的可以设置沉浸式体验，但也仅仅是操作状态栏和导航栏的显示与隐藏。

1.1.1 FLAGTRANSLUCENTSTATUS

当沉浸式全屏模式启用的时候，你的 activity 会继续接受各类的触摸事件。用户可以通过在状态栏与导航栏原来区域的边缘向内滑动让系统栏重新显示。这个操作清空了 SYSTEMUIFLAGHIDENAVIGATION 和 SYSTEMUIFLAGFULLSCREEN，如果没有两个标志的话，系统栏重新变得可见。如果设置了两个标签的话，这个操作同时也触发了 View.OnSystemUiVisibilityChangeListener。然而， 如果你想让系统栏在一段时间后自动隐藏的话，你应该使用 SYSTEMUIFLAGIMMERSIVE_STICKY 标签。

展示了各种不同的“沉浸式”状态：

在上图中：

• 非沉浸模式 —— 展示了应用进入沉浸模式之前的状态。也展示了设置 IMMERSIVE 标签后用户滑动展示系统栏的状态。用户滑动后， SYSTEMUIFLAGHIDENAVIGATION 和 SYSTEMUIFLAG_FULLSCREEN 就会被清除，系统栏就会重新显示并保持可见。请注意，最好的方式就是让所有的 UI 控件与系统栏的显示隐藏保持同步，这样可以减少屏幕显示所处的状态，同时提供了更无缝平滑的用户体验。因此所有的UI控件跟随系统栏一同显示。一旦应用进入了沉浸模式，UI 控件也跟随着系统栏一同隐藏。为了确保 UI 的可见性与系统栏保持一致，我们需要一个监听器 View.OnSystemUiVisibilityChangeListener 来监听系统栏的变化。这在下一节中将详细讲解。

• 提示气泡——第一次进入沉浸模式时，系统将会显示一个提示气泡，提示用户如何再让系统栏显示出来。请注意，如果为了测试你想强制显示提示气泡，你可以先将应用设为沉浸模式，然后按下电源键进入锁屏模式，并在 5 秒中之后打开屏幕。

• 沉浸模式—— 这张图展示了隐藏了系统栏和其他UI控件的状态。你可以设置 IMMERSIVE 和 IMMERSIVE_STICKY 来进入这个状态。

• 粘性标签——这就是你设置了 IMMERSIVE_STICKY 标签时的 UI 状态，用户会向内滑动以展示系统栏。半透明的系统栏会临时的进行显示，一段时间后自动隐藏。滑动的操作并不会清空任何标签，也不会触发系统 UI 可见性的监听器，因为暂时显示的导航栏并不被认为是一种可见的状态。

注意，immersive 类的标签只有在与 SYSTEMUIFLAGHIDENAVIGATION、SYSTEMUIFLAG_FULLSCREEN 中一个或两个一起使用的时候才会生效。你可以只使用其中的一个，但是一般情况下你需要同时隐藏状态栏和导航栏以达到沉浸的效果。

1.1.2 两种使用这个属性的方式：

• 在使用时候，我们通常需要考虑的是状态栏一值显示在顶部而不会隐藏或者被遮挡(其他 app 情况如：读书 app 或者是游戏 app 则需要隐藏顶部状态栏)，所以只需要通过代码设置 FLAGTRANSLUCENTSTATU：

1. activity.getWindow().addFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);

• 通过主题theme设置属性windowTranslucentStatus：

1. <style name="Theme" parent="Theme.Design.Light.NoActionBar">

2. <item name="android:windowTranslucentStatus">true</item>

3. </style>

效果如下：

效果如上图，可以看出，沉浸式的效果是出来了，但是也有一个问题，我们的标题栏和状态栏重叠了，相当于整个布局上移了StatusBar 的高度。

为了让标题栏回到原来的位置并且适应标题栏的颜色，我们在标题栏的上方添加一个大小和 StatusBar 大小一样假的状态栏 View,View 的 BackgroundColor 可以自己设置成标题栏一样的颜色也可以是其他颜色，这个 View 起到一个占位的作用。这个时候，标题栏就会下移 StatusBar 的高度，回到正常的位置。

通过设置 paddingTop 重新绘制标题栏高度代码如下：

1. View statusBarView = mDecorView.findViewById(IMMERSION_STATUS_BAR_VIEW);

2. if (statusBarView == null) {

3. statusBarView = new View(mActivity);

4. FrameLayout.LayoutParams params = new FrameLayout.LayoutParams(FrameLayout.LayoutParams.MATCH_PARENT,

5. mBarConfig.getStatusBarHeight());

6. params.gravity = Gravity.TOP;

7. statusBarView.setLayoutParams(params);

8. statusBarView.setVisibility(View.VISIBLE);

9. statusBarView.setId(IMMERSION_STATUS_BAR_VIEW);

10. mDecorView.addView(statusBarView);

11. }

12. if (mBarParams.statusBarColorEnabled) {

13. statusBarView.setBackgroundColor(ColorUtils.blendARGB(mBarParams.statusBarColor,

14. mBarParams.statusBarColorTransform, mBarParams.statusBarAlpha));

15. } else {

16. statusBarView.setBackgroundColor(ColorUtils.blendARGB(mBarParams.statusBarColor,

17. Color.TRANSPARENT, mBarParams.statusBarAlpha));

18. }

添加上述代码后，效果如下：

通过以上就可以实现 Android 4.4 上的沉浸式状态栏。

小结：Android4.4-Android5.0的步骤就是为window添加 FLAGTRANSLUCENTSTATUS 的 Flag,然后添加一个假的状态栏，通过上述方法设置的沉浸式在 Android4.4-Android5.0 之间的效果如贴图，状态栏顶部是有一个黑色阴影渐变，在5.0版本版本以上被修复了。如果是一张图片沉浸到状态栏则不需要设置这个假的状态栏，只需要设置，FLAGTRANSLUCENTSTATUS 就 OK。并且在 Android4.4-Android5.0 是没有提供改变状态颜色的属性，所以只能通过新增加一个假的状态栏方式改变背景颜色。

1.2 Android5.0 以上设置状态栏背景颜色

Android 5.0 是一个里程碑式的版本，从Android 5.0 开始，Google 推出了全新的设计规范 Material Design,并且原生控件就可以实现一些炫酷的 UI 动效。从这个版本开始，google 加入了一个比较重要的方法 setStatusBarColor (对应属性：android:statusBarColor),通过这个方法，可以很轻松地实现沉浸式状态栏。方法如下：

1. public abstract void setStatusBarColor(@ColorInt int color);

注意看这个方法的注释，想要这个方法生效，必须还要配合一个Flag一起使用，必须设置 FLAGDRAWSSYSTEMBARBACKGROUNDS ,并且不能设置 FLAGTRANSLUCENTSTATUS(Android 4.4 才用这个),所以和 4.4 互斥不能共用。所以Android5.0以上可以设置状态栏和导航栏背景颜色，但还不能改变状态栏和导航栏图标和字色。

1.2.1 FLAGDRAWSSYSTEMBARBACKGROUNDS 属性

解释：设置了 FLAGDRAWSSYSTEMBARBACKGROUNDS,表明会 Window 负责系统bar的 background 绘制，绘制透明背景的系统 bar（状态栏和导航栏），然后用 getStatusBarColor() 和 getNavigationBarColor() 的颜色填充相应的区域。这就是 Android 5.0 以上实现沉浸式导航栏的原理。

实现沉浸式添加如下代码：

1. getWindow().addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS);

2. //注意要清除 FLAG_TRANSLUCENT_STATUS flag

3. getWindow().clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);

4. getWindow().setStatusBarColor(getResources().getColor(android.R.color.holo_red_light));

效果如下：

如果在开发的时候是通过设置主题的方式设置，则需要在values-v21文件夹下添加如下主题，达到兼容目的

1. <style name="Theme" parent="Theme.Design.Light.NoActionBar">

2. <item name="android:windowTranslucentStatus">false</item>

3. <item name="android:windowDrawsSystemBarBackgrounds">true</item>

4. <item name="android:statusBarColor">@android:color/holo_red_light</item>

5. </style>

1.2.2 图片延伸到状态栏

在 Android 5.0 使图片延伸到状态栏，只需设置 windowTranslucentStatus,将 statusBarColor 设置为透明即可。主题方式设置如下：

1. <style name="ImageTranslucentTheme" parent="Theme.AppCompat.DayNight.NoActionBar">

2. <item name="android:windowTranslucentNavigation">true</item>

3. <item name="android:windowTranslucentStatus">true</item>

4. <!-- 设置statusBarColor 为透明-->

5. <item name="android:statusBarColor">@android:color/transparent</item>

6. </style>

在开发过程中，使用代码设置 windowTranslucentStatus 需要通过版本号的判断兼容 Android5.0 以下和 Android 5.0 以上。

1.3 Android 6.0 +实现状态栏字色和图标浅黑色

使用 Android6.0 以下版本沉浸式的时候会遇到一个问题，那就是 Android 系统状态栏的字色和图标颜色为白色，当状态栏颜色接近浅色的时候，状态栏上的内容就看不清了。Android 6.0 新添加了一个属性来解决这个问题，属性是 SYSTEMUIFLAGLIGHTSTATUS_BAR，可以设置状态栏字色和图标浅黑色。

1.3.1 SYSTEMUIFLAGLIGHTSTATUS_BAR

解释：为 setSystemUiVisibility(int) 方法添加的 Flag,请求 status bar 绘制模式，它可以兼容亮色背景的status bar 。要在设置了 FLAGDRAWSSYSTEMBARBACKGROUNDSflag ,同时清除了 FLAGTRANSLUCENTSTATUSflag 才会生效。

通过代码设置：

1. if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {

2. getWindow().getDecorView().setSystemUiVisibility(

3. View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN|View.SYSTEM_UI_FLAG_LIGHT_STATUS_BAR);

4. }

效果如下：

并且还可以在主题中使用属性,并且该主题需要放在 values-v23 文件夹下相应 Android6.0 以上才能生效：

1. <style name="Theme" parent="Theme.Design.Light.NoActionBar">

2. <item name="android:windowTranslucentStatus">false</item>

3. <item name="android:windowDrawsSystemBarBackgrounds">true</item>

4. <item name="android:statusBarColor">@android:color/holo_red_light</item>

5. <!-- Android 6.0以上 状态栏字色和图标为浅黑色-->

6. <item name="android:windowLightStatusBar">true</item>

7. </style>

二、ZanImmersionBar 轮子的原理和使用

在实际开发过程中，我们不仅仅只会遇到以上三种版本兼容问题，还需要考虑如：不同手机品牌，动态该状态栏背景，以及 Fragment 中需要有自己的状态栏颜色场景。所以需要综合考虑多种场景，达到能适配多种开发情况的要求。

总结出以下场景：

综合以上场景并且参考github例子进行封装之后得到了 ZanImmersionBar 这个轮子

2.1 原理：

我们希望将设置沉浸式效果都封装在一个类里面，想达到所有的效果通过一个方法设置，但很多的效果中都会有重复的设置步骤，并且每个效果的方法太多则分不清使用哪个，所以将设置沉浸式效果拆分成几个步骤，而想要设置个性效果，通过方法设置参数，最后通过init方法收集所有参数让后统一设置参数属性。

1. ZanImmersionBar.with(this).init();//该方法将进行以下步骤处理沉浸式

2. public void init() {

3. //更新Bar的参数

4. updateBarParams();

5. //设置沉浸式

6. setBar();

7. //适配状态栏与布局重叠问题

8. fitsLayoutOverlap();

9. //适配软键盘与底部输入框冲突问题

10. fitsKeyboard();

11. //变色view

12. transformView();

13. }

沉浸式设置流程如下图：

这几个步骤其中，获取参数和设置沉浸式是必须经过，下面三种设置是在开发中可能遇到的情况，也是设置参数，如果匹配到了则会进行三种设置的处理，接下来主要分析下第一个步骤和第二步骤。

2.1.1 收集 bar 参数

我们使用一个对象用于存储用户设置的 bar 参数，这些参数有状态栏和导航栏颜色、透明度、显示隐藏等等,通过该对象中的参数来分别设置

1. public class BarParams implements Cloneable {

2. /**

3. * 状态栏颜色

4. */

5. @ColorInt

6. int statusBarColor = Color.TRANSPARENT;

7. /**

8. * 导航栏颜色

9. */

10. @ColorInt

11. int navigationBarColor = Color.BLACK;

12. /**

13. * The Default navigation bar color.

14. */

15. int defaultNavigationBarColor = Color.BLACK;

16. /**

17. * 状态栏透明度

18. */

19. @FloatRange(from = 0f, to = 1f)

20. float statusBarAlpha = 0.0f;

21. /**

22. * 导航栏透明度

23. */

24. @FloatRange(from = 0f, to = 1f)

25. float navigationBarAlpha = 0.0f;

26. //等其他属性

27. ...

28. }

而这些属性可以通过以下ZanImmersionBar提供的方法进行个性化设置，而这些方法只是将需要设置的参数添加到BarParams对象中，最后必须调用init将参数设置上去。

1. ZanImmersionBar.with(this)

2. .transparentStatusBar() //透明状态栏，不写默认透明色

3. .transparentNavigationBar() //透明导航栏，不写默认黑色(设置此方法，fullScreen()方法自动为true)

4. .transparentBar() //透明状态栏和导航栏，不写默认状态栏为透明色，导航栏为黑色（设置此方法，fullScreen()方法自动为true）

5. .statusBarColor(R.color.colorPrimary) //状态栏颜色，不写默认透明色

6. .navigationBarColor(R.color.colorPrimary) //导航栏颜色，不写默认黑色

7. .barColor(R.color.colorPrimary) //同时自定义状态栏和导航栏颜色，不写默认状态栏为透明色，导航栏为黑色

8. .statusBarAlpha(0.3f) //状态栏透明度，不写默认0.0f

9. .navigationBarAlpha(0.4f) //导航栏透明度，不写默认0.0F

10. .barAlpha(0.3f) //状态栏和导航栏透明度，不写默认0.0f

11. .statusBarDarkFont(true) //状态栏字体是深色，不写默认为亮色

12. .navigationBarDarkIcon(true) //导航栏图标是深色，不写默认为亮色

13. //等一些其他方法

14. .init(); //必须调用方可沉浸式

设置完参数后，则需要收集这些参数，如果在Fragment中使用，则需要Activity同步Fragment的BarParams参数

1. //获得Bar相关信息

2. //如果在Fragment中使用，让Activity同步Fragment的BarParams参数

3. if (mIsFragment) {

4. ZanImmersionBar immersionBar = mImmersionBarMap.get(mActivity.toString());

5. if (immersionBar != null) {

6. immersionBar.mBarParams = mBarParams;

7. }

8. }

mImmersionBarMap 是个 Map，用于存储每个 Activity 对应的 ZanImmersionBar 对象

• 原理：其实我们通过沉浸式三代发展史，我们可以知道设置沉浸式都是通过改变Activity的window属性达到沉浸式，所以我们想要在Fragment的定制化沉浸式，其实是通过改变Activity的BarParams参数再设置Activity的沉浸式，所以需要注意对Fragment设置沉浸式前必须保证加载Fragment的Activity先进行了ZanImmersionBar的init初始化。

• 另例：需要注意dialogFragment和Dialog是有自己的window，该window是属于所属Activity的子window，所以设置dialogFragment和Dialog的沉浸式改变的是自己window里的属性，而不是改变Actvity的window里的属性。

• 关闭销毁：在activity的onDestroy方法中执行，因为mImmersionBarMap存储了每个Activity对应的ZanImmersionBar对象，所以当Activity关闭了需要及时释放，不然mImmersionBarMap会存在过多无用的ZanImmersionBar对象。

1. ZanImmersionBar.with(this).destroy(); //必须调用该方法，防止内存泄漏

2. public void destroy() {

3. //取消监听

4. cancelListener();

5. //删除当前界面对应的ImmersionBar对象

6. Iterator<Map.Entry<String, ZanImmersionBar>> iterator = mImmersionBarMap.entrySet().iterator();

7. while (iterator.hasNext()) {

8. Map.Entry<String, ZanImmersionBar> entry = iterator.next();

9. if (entry.getKey().contains(mImmersionBarName) || (entry.getKey().equals(mImmersionBarName))) {

10. iterator.remove();

11. }

12. }

13. }

2.1.2 初始化状态栏和导航栏

该方法则是将上一步的参数进行初始化，初始化过程则会根据沉浸式三个阶段和不同厂商进行区分设置。需要注意小米手机系统有自己定制化设置的属性，所以需要分区设置：

1. private void setBar() {

2. if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {

3. if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP && !OSUtils.isEMUI3_x()) {

4. //适配刘海屏

5. fitsNotchScreen();

6. //初始化5.0以上，包含5.0

7. uiFlags = initBarAboveLOLLIPOP(uiFlags);

8. //android 6.0以上设置状态栏字体为暗色

9. uiFlags = setStatusBarDarkFont(uiFlags);

10. //android 8.0以上设置导航栏图标为暗色

11. uiFlags = setNavigationIconDark(uiFlags);

12. } else {

13. //初始化5.0以下，4.4以上沉浸式

14. initBarBelowLOLLIPOP();

15. }

16. ...

17. }

18. if (OSUtils.isMIUI6Later()) {

19. //修改miui状态栏字体颜色

20. setMIUIBarDark(mWindow, MIUI_STATUS_BAR_DARK, mBarParams.statusBarDarkFont);

21. //修改miui导航栏图标为黑色

22. if (mBarParams.navigationBarEnable) {

23. setMIUIBarDark(mWindow, MIUI_NAVIGATION_BAR_DARK, mBarParams.navigationBarDarkIcon);

24. }

25. }

26. ...

27. }

我们可以重点看下5.0以上状态栏和导航栏初始化，设置初始化window属性让后设置导航栏和状态栏颜色。

1. @RequiresApi(api = Build.VERSION_CODES.LOLLIPOP)

2. private int initBarAboveLOLLIPOP(int uiFlags) {

3. //Activity全屏显示，但状态栏不会被隐藏覆盖，状态栏依然可见，Activity顶端布局部分会被状态栏遮住。

4. uiFlags |= View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN;

5. mWindow.clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);

6. //判断是否存在导航栏

7. if (mBarConfig.hasNavigationBar()) {

8. mWindow.clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_NAVIGATION);

9. }

10. //需要设置这个才能设置状态栏和导航栏颜色

11. mWindow.addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS);

12. //设置状态栏颜色

13. if (mBarParams.statusBarColorEnabled) {

14. mWindow.setStatusBarColor(ColorUtils.blendARGB(mBarParams.statusBarColor,

15. mBarParams.statusBarColorTransform, mBarParams.statusBarAlpha));

16. } else {

17. mWindow.setStatusBarColor(ColorUtils.blendARGB(mBarParams.statusBarColor,

18. Color.TRANSPARENT, mBarParams.statusBarAlpha));

19. }

20. ...

21. return uiFlags;

22. }

通过代码分析可以看到其实 ZanImmersionBar 所做的事情就是将设置沉浸式方法进行步骤拆分和增加个性属性设置，并且将沉浸式三个阶段和不同厂商进行区分独立方法设置调用。

2.2 建议和使用

• 建议在 BaseActivity 中初始化和销毁

1. public class BaseActivity extends AppCompatActivity {

2. @Override

3. protected void onCreate(@Nullable Bundle savedInstanceState) {

4. super.onCreate(savedInstanceState);

5. // 所有子类都将继承这些相同的属性,请在设置界面之后设置

6. ZanImmersionBar.with(this).init();

7. }

8. @Override

9. protected void onDestroy() {

10. super.onDestroy();

11. // 必须调用该方法，防止内存泄漏

12. ZanImmersionBar.with(this).destroy();

13. }

14. }

• 展示 Activity 中使用效果

2.3 在 Fragment 使用 ZanImmersionBar

注意在 Fragment 中使用 ZanImmersionBar 需要在承载的 Activity 中初始化 ZanImmersionBar,不然会抛出异常。

1. public abstract class BaseFragment{

2. @Override

3. public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) {

4. super.onViewCreated(view, savedInstanceState);

5. initImmersionBar();

6. }

7. @Override

8. public void initImmersionBar() {

9. ZanImmersionBar.with(this).keyboardEnable(true).init();

10. }

11. }

具体的Fragment调用以下方法:

1. @Override

2. public void initImmersionBar() {

3. super.initImmersionBar();

4. ZanImmersionBar.with(this)

5. .statusBarDarkFont(true)

6. .statusBarColor(R.color.btn1)

7. .navigationBarColor(R.color.btn1)

8. .init();

9. }

• 设置 Fragment 的状态栏颜色和状态栏字体颜色效果

2.4 在 Dialog 中实现沉浸式

在 Dialog 中设置 ZanImmersionBar 方式和在 Fragment 或者 Activity 一样，如果在 Fragment 或者 Activity 中有设置并且 dialog 出现不需要改变状态栏则不用设置 ZanImmersionBar，如果需要做定制化上面的高级用法在 Dialog 也支持

• 结合 dialogFragment 中使用

1. ZanImmersionBar.with(this).init();

• 其他dialog

1. ZanImmersionBar.with(this, dialog).init();

2.5 在 PopupWindow 中实现沉浸式

重点是调用以下方法，但是此方法会导致有导航栏的手机底部布局会被导航栏覆盖，还有底部输入框无法根据软键盘弹出而弹出。这个属性在顶部弹出的时候是需要使用，如果是底部弹框需要看情况而定。

1. popupWindow.setClippingEnabled(false);

2.6 状态栏与布局顶部重叠解决方案，六种方案任选其一（可选）

正常使用 ZanImmersionBar 一般不需要考虑重叠问题但在项目中接入 ZanImmersionBar 并且页面没有考虑给头部控件预留出状态栏的高度，并且需要将页面内容沉浸到状态栏或者做定制化状态栏，这种情况下需要考虑重叠问题。之前说到 Android4.4 版本的时候解决重叠的方式是一种，也可以参考一下几种方式解决状态栏与布局顶部重叠问题。

① 使用 dimen 自定义状态栏高度，不建议使用，因为设备状态栏高度并不是固定的

在 values-v19/dimens.xml 文件下

1. <dimen name="status_bar_height">25dp</dimen>

在values/dimens.xml文件下

1. <dimen name="status_bar_height">0dp</dimen>

然后在布局界面添加view标签，高度指定为statusbarheight

1. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"

2. xmlns:app="http://schemas.android.com/apk/res-auto"

3. android:layout_width="match_parent"

4. android:layout_height="match_parent"

5. android:background="@color/darker_gray"

6. android:orientation="vertical">

7. <View

8. android:layout_width="match_parent"

9. android:layout_height="@dimen/status_bar_height"

10. android:background="@color/colorPrimary" />

11. <android.support.v7.widget.Toolbar

12. android:layout_width="match_parent"

13. android:layout_height="wrap_content"

14. android:background="@color/colorPrimary"

15. app:title="方法一"

16. app:titleTextColor="@android:color/white" />

17. </LinearLayout>

② 使用系统的fitsSystemWindows属性，使用该属性不会导致输入框与软键盘冲突问题，不要再Fragment使用该属性

1. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"

2. android:layout_width="match_parent"

3. android:layout_height="match_parent"

4. android:orientation="vertical"

5. android:fitsSystemWindows="true">

6. </LinearLayout>

然后使用ImmersionBar时候必须指定状态栏颜色

1. ZanImmersionBar.with(this)

2. .statusBarColor(R.color.colorPrimary)

3. .init();

注意：ZanImmersionBar一定要在设置完布局以后使用

③ 使用ZanImmersionBar的fitsSystemWindows(boolean fits)方法

1. ZanImmersionBar.with(this)

2. .fitsSystemWindows(true) //使用该属性,必须指定状态栏颜色

3. .statusBarColor(R.color.colorPrimary)

4. .init();

④ 使用ZanImmersionBar的statusBarView(View view)方法

在标题栏的上方增加View标签，高度指定为0dp

1. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"

2. xmlns:app="http://schemas.android.com/apk/res-auto"

3. android:layout_width="match_parent"

4. android:layout_height="match_parent"

5. android:background="@color/darker_gray"

6. android:orientation="vertical">

7. <View

8. android:layout_width="match_parent"

9. android:layout_height="0dp"

10. android:background="@color/colorPrimary" />

11. <android.support.v7.widget.Toolbar

12. android:layout_width="match_parent"

13. android:layout_height="wrap_content"

14. android:background="@color/colorPrimary"

15. app:title="方法四"

16. app:titleTextColor="@android:color/white" />

17. </LinearLayout>

然后使用ZanImmersionBar的statusBarView方法，指定view就可以啦

1. ZanImmersionBar.with(this)

2. .statusBarView(view)

3. .init();

4. //或者

5. //ZanImmersionBar.setStatusBarView(this,view);

⑤ 使用ZanImmersionBar的titleBar(View view)方法，原理是设置paddingTop

1. ZanImmersionBar.with(this)

2. .titleBar(view) //可以为任意view，如果是自定义xml实现标题栏的话，最外层节点不能为RelativeLayout

3. .init();

4. //或者

5. //ZanImmersionBar.setTitleBar(this, view);

⑥ 使用ZanImmersionBar的titleBarMarginTop(View view)方法，原理是设置marginTop

1. ZanImmersionBar.with(this)

2. .titleBarMarginTop(view) //可以为任意view

3. .statusBarColor(R.color.colorPrimary) //指定状态栏颜色,根据情况是否设置

4. .init();

5. //或者使用静态方法设置

6. //ZanImmersionBar.setTitleBarMarginTop(this,view);

总结

在处理 Android 沉浸式状态栏和导航栏开始会很头大，并且会不理解相关设置的 window 的 FLAG 属性，想要分清楚这些属性的大意需要从出现背景出发拆封，先熟悉沉浸式出现的3个阶段的属性和版本能做什么和不能做什么，然后再去了解各个厂家定制化的属性在哪些版本阶段使用，以及是否需要对异形屏适配，最后才是在实际开发和需求中对状态栏和导航栏处理。不过在 Android6.0 以后版本厂家的定制化状态已经越来越没有意义了，以后 Android 原生趋势也将会让开发者使用沉浸式越来越舒服。

扩展阅读

-The End-

Vol.210

有赞技术团队为 442 万商家，150 个行业，330 亿电商交易额提供技术支持微商城｜零售｜美业 | 教育微信公众号：有赞coder    微博：@有赞技术技术博客：tech.youzan.comThe bigger the dream, the more important the team.